                
                FILE 2.0 (C) 1994 by Dean R. Madsen, KE0WO
            Traduccin de LW1DRJ - Daniel Magnoli para ARM BBS


Luego de varios requerimientos sobre alguna manera automtica de guardar en 
archivos determinados boletines o mensajes, se ha creado el siguiente programa
que trabaja en las versiones de FBB desde la 5.15 hasta la 7.00i, tanto MSDOS
como WIN. Puede NO TRABAJAR EN LA VERSION 78.00e.


Caractersticas:

El programna selecciona mensajes o boletines basados en una combinacin de
datos tales como los campos "De" ("From"), "A" ("To"), "@BBS", BID y/o el
asunto de los mismos y los guarda como archivo ded texto en un directorio
definido a tal efecto en el archivo de configuracin.
Se puede usar el comodn "*" en la configuracin (*palabra, palab*, *ala*,).
Existen 11 maneras u opciones de nombrar los archivos creados por el programa.
El programa lee el archivo INIT.SRV para obtener los datos de la estacin.
Un mismo boletn o mensaje puede ser guardado por distintos calificadores 
de bsqueda.
Por cada proceso de extraccin se crea un archivo de indice en formato texto.
Los archivos creados se pueden agregar al YAPPLBL.SYS con una descripcin.
Las lneas "R" o encabezados, pueden ser omitidas en el momento de la 
creacin del archivo.


Usos:

Archivo de correo personal fuera del MAIL.IN
Archivo de boletines de determinados temas en forma organizada.


Instalacin:

Slo hay que poner todos los archivos llamados FILE, presentes en este paquete,
dentro del directorio donde se localiza el INIT.SRV (usualmente C:\FBB).
Los archivos son: FILE.ADD, FILE.CFG, FILE.EXE, FILE.NUM, FILE.REJ, INDEX.FIL
y FILE.TXT


Archivo FILE.ADD:
El contenido de este archivo es agregado al comienzo de cada mensaje guardado
por FILE. Si el archivo no existe o no contiene nada, no se agrega nada...


Archivo INDEX.FIL
El contenido de INDEX.FIL precede cada lnea del archivo de ndice.


Archivo FILE.NUM
Contiene slo el nmero del ltimo boletn escaneado en el BBS. Si se borra
este nmero comienza de nuevo desde el primer boletn presente en el BBS.


Archivo FILE.CFG
Este es el archivo principal de configuracin.
Todas las lneas que comiencen con un # sern consideradas como comentarios.
Los campos se separan con comas (,) y se pueden crear hasta 173 lneas de
bsqueda.
NO DEBEN EXISTIR ESPACIOS EN BLANCO EN LAS LINEAS SALVO EN EL CAMPO ASUNTO.

El formato de la lnea es:

Tipo,De,@BBS,A,BID/MID,ASUNTO,Drive:\directorio\,mtodo de guardado,Indexado
(Type,From,@BBS,TO,BID/MID,SUBJECT,Drive:\PATH\,Save method,Indexing)

OTRA VEZ: SIN ESPACIOS INTERMEDIOS !!!!!!

EJEMPLOS:

# Guarda como archivo todos los boletines:
B,*,*,*,*,*,C:\BOLETINES\,1,1

# Guarda todos los mensajes de LW1DRJ
*,LW1DRJ,*,*,*,*,C:\LW1DRJ\,1,1

# Guarda todos los mensajes distribudos a LUNET en el directorio C:\LUNET
*,*,LUNET,*,*,*,C:\LUNET\,1,1

# Guarda todos los mensajes para KE0WO
*,*,*,KE0WO,*,*,C:\KE0WO\,1,1

# Guarda todos los mensajes con BID/MID finalizado en _LW1DRJ (o todos los
# mensajes originados en LW1DRJ BBS)

*,*,*,*,*_LW1DRJ,*,C:\LOCAL\,1,1

# Guarda todos los mensajes con la cadena "SOAM" en el asunto (se respetan
# MAYUSCULAS / minsculas)
*,*,*,*,*,*SOAM*,C:\SOAM\,1,1

Ahora se muestran algunas combinaciones de filtrado:

# Guarda todos los mensajes enviados a FBB @ LATNET desde cualquier estacin
# con el prefijo "LU"
*,LU*,LATNET,FBB,*,*,C:\FBBVS\,1,1

# Guarda todos los mensajes personales para SYSOP con el trmino "ILEGAL"
# en el asunto
P,*,*,SYSOP,*,*ILEGAL*,C:\SYSOP\,1,1

# Guarda todos los boletines de LW1DRJ a MAP* con la ruta de distribucin
# GBANET
B,LW1DRJ,GBANET,MAP*,*,*,C:\FILES\MAPS\,1,1


Las siguientes on las opciones para nombrar los archivos creados:


1  -   Guarda por el nro. local asignado por el FBB 
       (el mensaje # 100101 se guardar como file 100101.)

2  -   Guarda por BID/MID.

3  -   Guarda por el nombre indicado en el campo directorio (directory).
       Si el directorio es C:\FILES\STUFF,3, los mensajes se guardarn 
       como C:\FILES\STUFF.001 hasta C:\FILES\STUFF.999

4  -   Guarda usando un nombre y extensin fijos definidos y los va agregando
       siempre el mismo archivo. Si se define el nombre C:\FILES\PEPE.TXT,3
       TODOS LOS MENSAJES SERAN GUARDADOS CON ESE NOMBRE EN ESE DIRECTORIO,
       AGREGANDO SIEMPRE AL MISMO ARCHIVO. NO REEMPLAZA EL ORIGINAL SINO QUE
       "AGREGA" MAS DATOS. Recordar que se crean archivos de texto.

5  -   Nombra el archivo usando el campo "De" y le asigna la extensin ".001"
       hasta ".999"

6  -   Guarda usando el campo "De" y agrega los mensajes siguientes al mismo
       archivo.

7  -   Usa el campo "A", agregando la extensin .001 a .999

8  -   Nombra los archivos usando el campo "A" y agrega al final los siguientes.

9  -   Usa el campo "@bbs", con extensin .001 - .999

0  -   Usa el campo "@bbs". Agrega mensajes posteriores.

10 -   Usa la fgecha en formato YYMMDD y agrega posteriores.


           
Estas son las opciones de indexado:

0   -   No indexa.

1   -   Crea un archivo de texto con el resmen de lo extractado

2   -   Agrega el archivo al YAPPLBL.SYS.

3   -   Crea un archivo de texto y adems lo agrega al YAPPLBL.SYS.

4   -   No indexa.  Borra las lneas R: de encabezados.

5   -   Crea un archivo de texto y borra las lneas R:.

6   -   Agrega al YAPPLBL.SYS y borra las lneas :R.

7   -   Crea un archivo de texto y adems lo agrega al YAPPLBL.SYS.
        Borra las lneas R:


Archivo FILE.REJ
Bsicamente es un REJECT.SYS y usa los parmetros del FILE.CFG.


El formato de la lnea es:

Tipo,De,@BBS,A,BID/MID,ASUNTO
(Type,From,@BBS,TO,BID/MID,SUBJECT)

El resto es igual al FILE.CFG.


VARIABLES

Para permitir la personalizacin del programa, se han implementado las
siguientes variables en los distintos archivos de configuracin.
Cada variable debe comenzar por el signo $ y estar siempre en minsculas:


$@        - Campo @BBS del mensaje a ser guardado.
$@_       - Campo @BBS formateado a 7 caracteres.
$thisbbs  - Distintiva tomada del INIT.SRV.
$to       - Campo "A" ("To") del mensaje a ser guardado.
$to_      - Campo "A" ("To") formateado a 7 caracteres.
$type     - Tipo del mensaje a ser guardado.
$from     - Campo "DE" ("from") del mensaje a ser guardado.
$from_    - Campo "DE" ("from") del mensaje a ser guardado formateado a 7 caracteres.
$date     - Fecha orgen del mensaje en formato YYMMDD.
$dateusa  - Fecha orgen del mensaje en formato MM/DD/YY.
$dateeu   - Fecha orgen del mensaje en formato DD/MM/YY.
$time     - Hora de orgen del mensaje (hh:mm)
$msize    - Tamao del archivo creado al guardar el mensaje.
$bid      - BID/MID del mensaje.
$bid_     - BID/MID formateado a 13 caracteres.
$subject  - Asunto o ttulo del mensaje a ser archivado.
$filename - Nombre del archivo final.
$filename_- Nombre del archivo formateado a 14 caracteres.



-------------------------DONDE HAGO CORRER AL PROGRAMA ?????-----------------

Usualmente se coloca en el APPEL.BAT o en el RUNFBB.BAT pero ANTES del EPURMESS.
Obvio... no...?
Tambin se puede ejecutar a mano desde una ventana de DOS tipeando FILE [enter].

-------------------------------------------------------------------------------
FILE 2.0 es propiedad de Dean R. Madsen, KE0WO (C) 1994
-------------------------------------------------------------------------------